Release 10.1A: OpenEdge Development:
Progress Dynamics Basic Development

Creating menu item security allocations

You can also create security allocations for menu items.

To define an allocation for a menu item:

Open the Security allocation node and the Menu items subnode.
Specify the user, group, and login company information for the allocation.
(Optional) Set a filter. In the security system, there are usually long lists of items to scroll through. Using the standard Filter tab can speed up your work.
Click Refresh.
Note: When the browser displays more items than specified in the Rows to Batch field, scrolling to the end of the browse causes the next batch to be retrieved. Use a filter to reduce the list, or increase the size of Rows to Batch to fetch more values.

The browse window populates with available items.

Note: While browsing, keep in mind that the item label and item description displayed are not necessarily unique. The unique Item Reference code is not displayed here. You can set a restriction for all occurrences of the label if you want the restriction to apply everywhere it is used. Otherwise, you might want to consider using action security instead.

Another consideration when browsing is that by default the Items are sorted by label. The ampersand (&) shortcut character is part of the label, and sorts before alphabetic characters.

This example uses the objects from the tutorial OpenEdge Development: Progress Dynamics Getting Started . That sample application has a Menu Controller window with a standard Menu & Toolbar object, with an OrderEntry band added to it. The band has two menu items, Customers and Orders. Here you are applying a restriction for the user Anthony for the Customers item. Here the Customers item is used only in the oeband of the Menu Controller window that is in the sample application, as shown:



Select Customers from the Available Menu Items browser and click the button.
Click Save.
Start a new session, as shown.:



Use the Dynamic Launcher to test the sample application window, oemenuwin.
Check the Destroy ADM Super Procedures check box to force a re-cache of menu information, in order to see the effects of the menu change, as shown:



Drop down the OrderEntry menu to see that the Customers item is disabled. Note that menu items that are restricted are disabled rather than being completely hidden, unlike Menu Structures (Bands), as shown: